home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 08 System Utilities / TXTRDR.DOC < prev    next >
Text File  |  2019-04-13  |  4KB  |  93 lines
  1.                                 TXTRDR.IMG
  2.                                 ----------
  3.                    A New Text File Reader for the C-128
  4.  
  5.  
  6.       This is the documentation for TXTRDR.IMG, a text file loading
  7.     and display program for the 128.  This program is the direct
  8.     descendant of LDTXT.IMG for the 64 (found in DL4 on CBMCOM) and
  9.     operates on the same principle.
  10.  
  11.       Text files are loaded from disk into a large RAM buffer
  12.     (approximately 63K) and are displayed or printed from there.  The
  13.     fact that the files are loaded has several advantages: the drive
  14.     doesn't have to run the whole time you're reading a file on
  15.     screen, and you can view a file as many times as you like without
  16.     having to load it more than once.
  17.  
  18.  
  19.  
  20.                                  FEATURES
  21.                                  --------
  22.  
  23.     * The program runs in FAST mode (80 columns only).
  24.  
  25.     * Files up to 249 disk blocks can be loaded.
  26.  
  27.     * The directory can be viewed from within the program.
  28.  
  29.     * Files can be output to the screen or a printer.
  30.  
  31.     * Your printer's special features can be set up (margins,
  32.     skip-over-perf, etc).  The default setup is for a Gemini 10x with
  33.     Tymac's "The Connection" interface.
  34.  
  35.     * Files of either SEQ or PRG type can be loaded.
  36.  
  37.     * File conversion fron SEQ to PRG.
  38.  
  39.     * An assembly language routine handles the screen and printer
  40.     output (for improved speed).
  41.  
  42.  
  43.  
  44.                                  OPERATION
  45.                                  ---------
  46.  
  47.       Simply load and run TXTRDR.IMG from disk.
  48.  
  49.       To view the disk directory, answer 'y' to the prompt.  If you
  50.     change disks, just answer "y" to the "View Directory" or "View
  51.     Directory Again" prompts to see the new directory.
  52.  
  53.       When the program asks you to enter the name of the file,
  54.     remember to add the file type as well (name,s or name,p).  Either
  55.     file type can be loaded, but MUST contain only text.  SEQuential
  56.     files are loaded by a short ML routine.  I suggest that you save
  57.     your text files as type PRG.  This speeds loading considerably (it
  58.     allows use of the "burst" protocol).  If you do this, be sure to
  59.     put something in the file name to indicate it is a text file.
  60.     After you load and view a SEQ file, the program will ask whether
  61.     you want it saved in PRG format.
  62.  
  63.       The file will be loaded, and will be output to the screen or a
  64.     printer.  The screen display will pause each 23 lines.  When you
  65.     finish reading it, press the space bar and the screen will scroll
  66.     to the next page, leaving the last line on the previous page
  67.     visible.  The printer output will scroll 54 lines, then wait for
  68.     you to press the space bar.  At the end of any page, you can
  69.     terminate the output by pressing the "+" key.
  70.  
  71.  
  72.  
  73.                      TECHNICAL TIPS and MODIFICATIONS
  74.                      --------------------------------
  75.  
  76.       The majority of this program is in BASIC and can be easily
  77.     modified.  There are two ML routines, one to load SEQ files (at
  78.     $1300), and one to handle screen and printer output (at $0b00).
  79.     The programs all reside entirely in bank 15 (RAM bank 0), while
  80.     BASIC variables and the text buffer are in RAM Bank 1.
  81.  
  82.       The printer setup section can be easily modified, it's in lines
  83.     3000 and up in the BASIC portion.  REM's indicate each of the
  84.     functions.  To change the printer's secondary address (default =
  85.     7), change the value poked to $0b27 (line 50 in the BASIC program.
  86.  
  87.       This program is original.  Please make and distribute all the
  88.     copies you want, but don't sell it.  Please let me know any
  89.     comments, complaints, suggestions, etc., by Easyplex.
  90.  
  91.                          Alan Murphy [75236,1433]
  92.                               August 30, 1986
  93.